home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / Communication / MailHelper / README
Text File  |  1993-09-16  |  5KB  |  77 lines

  1. MailHelper -- A Service Provider for NeXT Mail.app.
  2. by Izumi Ohzawa, and Manuel Alberto Ricart.
  3.  
  4. V1.1 [9-22-1991]-- New features:
  5. 1.  Preferences panel has been added and user preferences are
  6.     stored in the default database [added by MAR].
  7. 2.  Insertion of RTF signature is now supported for NeXT mail as a
  8.     separate services menu item [added by IO].
  9.     
  10. V1.2 [10-9-91] -- Mitsuhiro Kishimoto added support Japanese text in the reformat function
  11.  
  12. (NOTE - As of this version the . signature and .signature.rtfd keyboard equivalents were modified to ' and " respectively to avoid conflict with other services)
  13.  
  14. V1.3 [9-10-93] -- Mike O'Neill (emo@mitre.org) added support for RTFD signatures (and a colorized icon)
  15.  
  16. [Version 1.3 Requires OS Release 3.0 or later]
  17.  
  18. -----
  19. This application has been written to correct deficiencies with the current NeXT Mail application, especially in the non-NeXT mail mode.  MailHelper corrects these problems and provides some additional enhancements via the "Services" menu of the Mail application.
  20.  
  21. It adds the following four features:
  22.  
  23. [1]  Text Reformatting
  24. It reformats pasted/forwarded text in a send window so that the text fits into about 60 column width.  Without reformatting, pasted-in text often appears ugly with alternating long and short lines due to inflexible line wrapping in the non-NeXT mail mode.  Paragraph boundaries defined by two consecutive newline characters will be preserved.
  25. To use this service, first paste in text into a send window, select  the text you want to reformat, and press "Services"---"Mail"---"Reformat Selection" (or Command-] ).
  26. Column width for wrapping may be changed via the Preferences panel, although values greater than 60 will not work well in non-NeXT mail. As of Version 1.2 MailHelper reformats Japanese text.
  27.  
  28. [2]  Quoting Text by Prefixed String.
  29. It adds "> " to the left of each text line of pasted text to indicate that it is quoted text.
  30. To use this service, select the text you want to indicate with the quotation marks, then press "Services"---"Mail"---"Quote Selection" (or Command-> ).
  31. You probably should reformat the text with "Reformat Selection" first before adding the quotation marks.  This prefix string for quoting may be changed via the Preferences panel.
  32.  
  33. [3]  Quoting RTF Text by Graying String.
  34. To use this service, select the text you want to gray, then press "Services"---"Mail"---"Gray Selection" (or Command-< ).
  35.  
  36. [4]    Signature Insertion
  37. It inserts the content of your signature file (default is " ~/.signature" ) at the current cursor position.  Path to the signature file may be changed via the Preferences panel. 
  38.  
  39.  To insert your signature, press "Services"---"Mail"---"Insert Signature" (or Command-' ).
  40.  
  41. When you prepare the ASCII signature file, make sure that all lines are shorter than 60 chars.  Otherwise, the inserted signature text may be wrapped at undesirable locations.
  42. In NeXT Mail mode, your signature in RTF (Rich Text Format)  or (as of Version 1.3) RTFD (default filenames are " ~/.signature.rtf and ~/.signature.rtfd")  may be inserted.  Paths to these files may also be changed via the Preferences panel. 
  43.  
  44.  To insert your RTF signature, press "Services"---"Mail"---"Insert RTF Signature" (or Command-" ).
  45.  
  46.  To insert your RTFD signature, press "Services"---"Mail"---"Insert RTFD Signature" (or Command-! ).
  47.  
  48.  
  49. Installation
  50.  
  51. Copy MailHelper.app to ~/Apps, or /LocalApps.  You will have to be 'root' to copy it to /LocalApps.   Logout, and log back in to see the new services appear in the Services menu of NeXT's Mail application.   If you are using the old version of MailHelper, it may be necessary to delete files ".applist" and ".cache" in directory ~/.NeXT/services before logout and logging back in.  This step makes sure that new services item is listed in the menu.
  52.  
  53. This program, being a service provider, actually works with many other programs including Edit, NewsGrazer, etc.  Command key equivalents may not work in the way explained here due to conflicting key assignments in these applications.
  54.  
  55. You may resolve key conflicts by changing the key assignments of any program by using the following dwrite:
  56.  
  57. dwrite AppName NXCommandKeys MenuItemName1,char1[, MenuItemName2,char2[...]]
  58.  
  59. where AppName is the name of the application whose command key assignments are to be over-ridden and MenuItemName is the name of the menu item to be assigned a new key equivalent. (for further information see NeXTAnswers - preferences.769)
  60.  
  61.  
  62. Notes and Copying Policy
  63.  
  64. Original version by Izumi Ohzawa
  65. Preferences panel has been added by Manuel Alberto Ricart.
  66. Japanese text reformatting by Mitsuhiro Kishimoto.
  67. RTFD signature, RTF quoting and Icon colorization by E.Michael O'Neill.
  68.  
  69. You are free to copy/modify/distribute this program as long as you do not remove the copyright notice in the info panel.  Nothing prevents you from adding yours in there.   Comments, bug reports or fixes, added features are welcome to the address below.
  70.  
  71.  
  72. E. Michael O'Neill
  73. emo@mitre.org (NeXTmail)
  74.  
  75. (NOTE - I undertook this update as an exercise in learning to write a Service. I do not intend to undertake further enhancements. If anyone wishes to continue this work please feel free! -emo)
  76.  
  77.